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/**************************************^^ 

* FUNCTION NAME = wUserFgndSetMode 

* DESCRIPTION 

* Save client machine CPU register state 

* Save video BIOS data area 

* Setup a VGA (or possibly VESA) BIOS call to set the current 

* client video mode in oraer to restore the VDM's state. 
* 

+mmm++++ ^ ++m ***********************^ 

wUserFgndSetModeQ j}>800 
I 

/* New art */ 

Save client CPU register state 
Save video BIOS data area 

setup VGA (or possibly VESA) BIOS call to set the current 

client video mode 
return to 
^ wUserFgndLogicalLineLength 

/***************************^^ 

* FUNCTION NAME = wUserFgndLogicalLineLength 

* DESCRIPTION 

* Setup a VESA BIOS call to set the logical scan line length 

* Useful for VESA BIOS not implementing full register restore. 
* 

******************************************************* 

wUserFgndLogicalLineLength() ^802 

i 

/* New art */ 

inject vesa call to restore 
logical scan length start registers from saved area 
return to 
^ wUserFgndDisplayStart, 

/***********************************m 

* FUNCTION NAME = wUserFgndDisplayStart 

* DESCRIPTION 

* Setup a VESA BIOS call to set the display start registers 

* inserts the int 10 instruction, and arms a return to 

* wUserFgndBankCopy. 
* 

***********************************^ ^804 
wUserFgndDisplayStart() 

\ 

/* New art */ 

inject vesa call to restore display start registers from saved area 
return to 
wUserFgndRegsSet, 
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* FUNCTION NAME = wUserFgndRegsSet 

* DESCRIPTION 

* Setup a VESA BIOS call to restore the clients adapter registers 
* 

wUserFgndRegsSet() 
/* New art */ 

inject vesa call to restore client adapter registers from saved area 
return to ,| 
^ wUserFgndBankSetlst, j 

* FUNCTION NAME = wUserFgndBankSetlst 

* DESCRIPTION 

* Setup a VESA BIOS call to set the VRAM bank number to 0; 

* ! 

wUserFgndBankSetl st() 

\ 

/* New art */ 

if( Mode uses Linear Frame Buffer ) 
transfer LINEAR buffer contents to VRAM from saved area 
inject vesa call to set A Bank to saved A bank 
return to 

vvUserFgndBankBSet, 

else 

pvd->VdmUser.lBankCopyNextBank = 0; 
inject vesa call to set A Bank to next bank # for restore 
return to 

^ wUserFgndBankCopySetBBank, 
* 

* FUNCTION NAME = wUserFgndBankCopySetBBank 

* DESCRIPTION 

* Set the B Bank Window if it is needed for read/write operations. 

* Most adapters only have an A Bank. 

* A few have an A Bank for reading and a B Bank for writing, 

* or vice versa. 

wUserFgndBankCopySetBBank() 

i 

/* New art */ 

inject vesa call to set B Bank to next bank § for restore 
return to 

wUserFgndBankCopy, 
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* FUNCTION NAME = wUserFgndBankCopy 

* DESCRIPTION 

* Transfers virtual memory to the VRAM bank, 

* and then setup a VESA BIOS call to access the next A bank. 
* 

* On the last pass, it does the transfer of virtual memory to the VRAM 

* bank, and then setup a VESA BIOS call to set the bank 

* number to the clients current A bank number. 

wUseifgndBankCopy() 
\ 

A Prior art */ J 812 
transfer one (current) bank of VRAM from saved area 
/* New art */ 
increment bank number 
if( copy bank < total banks ) 

inject vesa call to set A Bank to next bank § for restore 

return to 

wUserFgndBankCopySetBBank, 
else 

inject vesa call to set A Bank to client bank # 
return to 
^ wUserFgndBankBSet, 

* FUNCTION NAME = wUserFgndBankBSet 

* DESCRIPTION 

* Setup a VESA BIOS call to set the B bank 

* number to the clients current bank number. 

* Most adapters only have an A Bank. 

* A few have an A Bank for reading and a B Bank for writing, 

* or vice versa. 

* Useful for VESA BIOS not implementing full register restore. jj>814 
* 

wUserFgndBankBSet() 

inject vesa call to set B Bank to saved bank § 
return to 
^ wUserFgndRegsSetAtEnd, 

I FUNCTION NAME = wUserFgndRegsSetAtEnd 

* DESCRIPTION 

* Setup a VESA BIOS call to restore the client adapter 

* register set to clean up the registers changed 

* during the restoring the VRAM banks. ' 11*816 
* 

wUserFgndRegsSetAtEnd() 

^ inject vesa call to restore registers from saved state 
j return to FgndFinish 
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* FUNCTION NAME = wUserFgndFinish 

* DESCRIPTION 

* Finish foreground switch in VDM's context. 

* Restore the VGA register state directly. 

* Useful for VESA BIOS not implementing full register restore. 

* Restore client machine CPU register state saved 

* Restore video BIOS data area saved 

* Switch trapping behavior to transparent real hardware access. 
* 

wUserFgndFinishQ 

i 

/* Prior art */ 

restore VGA register state 

/* New art */ 

restore client machine CPU register state saved 
restore video BIOS data area saved 

/* Prior art */ 

switch trapping behavior to transparent real hardware access 
thaw VDM when in unemulatable (SVGA) video mode. 
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* FUNCTION NAME = vvUserBgndSaveSizeQuery 

* DESCRIPTION 

* Save the VGA register state directly. 

* Useful for VESA BIOS not implementing full register save. 

* Save client machine CPU register state 

* Save video BIOS data area 

* Setup a VESA BIOS call to get the clients SVGA regs save area size. 
* 

wUserBgndSaveSizeQuery() 

i 

/* New art */ 

bave client machine CPU register state 
Save video BIOS data area 

inject VESA BIOS all to get client SVGA regs save area size 
return to 
^ vvUserBgndRegsGet, 

* FUNCTION NAME = vvUserBgndRegsGet 

* DESCRIPTION 

* Checks the SVGA reqs save area size returned. 

* If the DOS allocated save area is large enough, 

* then it issues the VESA BIOS call to save the SVGA registers. ^QOO 

* Setup a VESA BIOS call to save adapter register state. yuz 
* 

wUserBgndRegsGetQ 

i 

/* New art */ 

Setup a VESA BIOS call to save adapter register state, 
return to 

vvUserBgndLogicalLineLength, 
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* 

* FUNCTION NAME = wUserBgndLogicalLineLength 

* DESCRIPTION 

* Setup a VESA BIOS call to get the clients VRAM bank number. 
* 

wUserBgndLogicalLineLengthQ 



^904 



/* New art */ 

Setup a VESA BIOS call to get the clients VRAM bank number, 
return to 
^ wUserBgndDisplayStart, 

* FUNCTION NAME = wUserBgndDisplayStart 

* DESCRIPTION 

* Save returned logical line length values. 

* Setup a VESA BIDS call to get the clients display start offset. 
* 

wUserBgndDisplayStart() 

i 

A New art */ 

save returnea logical line length values. 
Setup a VESA BIOS call to get the clients display start offset, 
return to 
^ wUserBgndBankGet, 

* FUNCTION NAME = wUserBgndBankGet 

* DESCRIPTION 

* Save returned display start values. 

* Setup a VESA BIOS call to get the clients VRAM A bank number. 
* 

wUserBgndBankGetQ 
I 

/* New art */ 

Save returnea display start values. 

Setup a VESA BIOS call to get the clients VRAM A bank number, 
return to 
^ wUserBgndBankBGet, 
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* 

* FUNCTION NAME = wUserBgndBankBGet 

* DESCRIPTION 

* Save returned A bank number. 

* Setup a VESA BIOS call to get the clients VRAM B bank number. 
* 

wUserBgndBankBGet() 5>9 ] Q 

I 

/* New art */ 

Save returnea A bank number, 
set current copy bank to -1 

Setup a VESA BIOS call to get the clients VRAM B bank number, 
return to 

wUserBgndBankCopy 

} /*@V4.0JAN01*/ 

FUNCTION NAME = wUserBgndBankCopy 

DESCRIPTION 

On the 1st pass, 
Save returned client B bank number. 
Setup a VESA BIOS call to set the VRAM bank number to 0. 

H>912 

On all middle passes, 
Transfers the VRAM bank to virtual storage, 
Setup a VESA BIOS call to access the next VRAM bank. 

On the last pass, 
Transfers the last VRAM bank to virtual storage, 
Setup a BIOS call to set VGA mode via wUserBgndVGAModeSet 

wUserBgndBankCopy() 

I 

/* New art */ 
if( copy bank < 0 ) 

save returned client B bank number 
else 

/* Prior art */ 

transfer one VRAM bank to saved area 
/* New art */ 

if( mode uses Linear Frame Buffer ) U Q1 L 

transfer whole linear buffer to save area f '° | 4f 

return to 
wUserBgndVGAModeSet 

else 

increment copy bank number 
if( copy bank number < total banks ) 

setup a VESA call to set copy A bank number. 

return to 

vvUserBgndBankCopySetBBank, 

else 

^ call wUserBgndVGAModeSet directly 
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* FUNCTION NAME = wUserBgndBankCopySetBBank 

* DESCRIPTION 

* Setup VESA BIOS call to set the copy B Bank Window, 

* if it is needed for read/write operations. 
* 

*********************************************************************************** V g 

wUserBgndBankCopySetBBank() 

i 

/* New art */ 

Setup VESA BIOS call to set the copy B Bank Window, 
return to 
^ vvUserBgndBankCopy 

^t***********************************************^^ 
** FUNCTION NAME = wUserBgndVGAModeSet 

* DESCRIPTION 

* Setup a VGA BIOS call to set a VGA standard video mode (mode 12). 

* This allows next operating system component manipulating tne 

* video hardware to assume tne SVGA is a simple/standard VGA. 

* / &-918 
wUserBgndVGAModeSet() 
I 

/* New art */ 

setup a VGA BIOS call to set a VGA standard video mode. ' 
return to vvUserBgndFlnish 
| /*§V4.0JAN01*/ 

/********************************************************************************************* 

* FUNCTION NAME = vvUserBgndFlnish 

* DESCRIPTION 

* Finish background switch in VDM's context 

* Freeze VDM when in unemulatable (SVGA) video mode. 

* Leave emulatable (VGA) video mode unfrozen. 
* 

***#******m************m n „ n 

wUserBgndFinish() 

i 

/* New art */ 

restore client CPU register state 
/* Prior art */ 

switch trapping behavior to emulation of hardware access 
freeze VDM when in unemulatable (SVGA) video mode. 
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/**************************************************************M^ 

I FUNCTION NAME = wlnit 

* DESCRIPTION 

* Initialization for virtual video driver 

* called by mvdm at start of each VDM 

* Most VESA BlOSes now provide PCI BIOS information too 
* 

*****************************************************************^^ 

wlnit() 

^ /* Prior art: */ 
register standard VGA I/O port address handlers with mvdm. 
/* New art: ♦/ 

make PCI BIOS call to get list of PCI BIOS I/O port addresses, 
for each PCI BIOS I/O port address 
I register PCI BIOS I/O port address handler with mvdm. 

•J**************************************************************^^ 

* FUNCTION NAME = mvdmlOHook 

* DESCRIPTION 

* All client I/O instructions generate a hardware trap which comes here 

* Handlers are generally all registered at the start of the VDM. 

* Video port hooking is enabled in the background, 

* and disabled in the foreground. 

* Non-video hardware follows other algorithms based on the 

* device driver requirements and sophistication. 
* 

****************************************************************^^ 

mvdmPortIOHook() 

/* All prior art */ 

if( registered handler for I/O port address 
&& hooking enabled for I/O port address ) 
call registered handler for 1/0 port address 

;e 

do I/O directly. 
s 

1****************************************************************^^ 

* FUNCTION NAME = wVGAStandardPortIOHook 
I DESCRIPTION 

* Typical registered hook handler for VGA Standard I/O port address 

* May be more complicated if I/O port not connected to a simple register 

* Such as pair of I/O ports for an index and data register array 

* Each I/O port address may have its own unique ana differently 

* coded handler to handle unusually behaving ports. 
* 

***************************************************************w 

wVGAStandardPortIOHook() 

/* All prior art */ 
if( input ) 

return ( emulation state variable value for I/O port address ) 
/* This goes into the client CPU register set */ 
else /* output */ 
Save output from client CPU register set 
into emulation state variable for I/O port address 
/* Will be used later to restore adapter contents */ 
Adjust any other emulation state variables required by changes to this port 



FIG. 11 B 
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/******************************************************^^ 

I FUNCTION NAME = wVGADataPortlOHook 

* DESCRIPTION 

* Typical registered hook handler for VGA Standard I/O port address 

* as a part of index and data port handler pair. 

* Index port handler is usually a wVGAStandardPortlOHook. 
* 

******************************^ 

wVGADataPortlOHookO 

/* All prior art */ 
if( input ) 

return ( emulation state variable [index port state vanablej 

value for I/O port address ) 
/* This goes into tne client CPU register set */ 
else /* output */ 
Save output from client CPU register set 
into emulation state variable [index port state variable] 

for I/O port address 
/* Will be used later to restore adapter contents */ 
Adjust any other emulation state variables required by changes to this port 

/***********************************************m 

FUNCTION NAME = wPCIPortlOHook 

DESCRIPTION 

Registered by the virtual video device driver for a list 
of port addresses provided by the PCI BIOS. 
ONLY registered hook handler type for PCI BIOS I/O port address. 
This represents a simple best guess to how a typical port works. 
But it often does not absolutely correct emulation. 
However it almost always suffices for emulating VGA modes. 
This is NOT true of SVGA modes, 

and this is why we freeze when in VESA modes in the background 
so that the video adapter is not incorrectly emulated. 
Emulation state variables used here 

will NOT be used later to restore adapter contents, !j>1108 
because we do not know how port really works! 
Instead we rely on the VESA BIOS calls to restore important registers. 

************************************************************** 

wPCIPortIOHook() 
I 

/* New art */ 
if( input ) 

return ( emulation state variable value for I/O port address ) 
/* This goes into the client CPU register set */ 
else /* output */ 
save output from client CPU register set 
into emulation state variable for I/O port address 
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;* FUNCTION NAME = wlntl OPreHook 
i * DESCRIPTION 

;* Quick Return if not Mode Set, 
; * else transfer control to 

;* , 

wInt10PreHook() 

^ if( AH( pcrf ) == 0x00) /* VGA Mode Set */ 
/* Prior art */ 

save client registers as last setmode registers 

wlntlOChain " 
t S>1200 
else if( AX( pcrf ) == 0x4F02 ) /* VESA Mode Set ♦/ 

/* Prior art: */ 

save client registers as last setmode registers 
/* From here begins new art: */ 
save VESA setmode number 
push client registers 

inject VESA call to get VESA BIOS SVGA INFO, 
^return to wlntlOVesaVbelnfoReturn 

else 

/* Prior art */ 
j wlntlOChain 

* 

* FUNCTION NAME = wlntlOVesaVbelnfoReturn 

* DESCRIPTION 

* Sets up for a VESA Mode query. 
* 

If 1 202 

wlntl OVesaVbeInfoReturn() 

' save VESA BIOS SVGA INFO including total VRAM size. 

inject VESA BIOS call to get MODE INFO for new mode. 

return to 
| wlntl OVesaModelnfoReturn 

* FUNCTION NAME = wlntl OVesaModelnfoReturn 
t DESCRIPTION 

* Gets the VESA mode information from the Mode information block and 

* copies it to the VDM's VESA mode information structure, and then 

* sets up to do the actual VESA BIOS mode set to the VESA mode. 
* 

VOID HOOKENTRY wlntl OVesaModeInfoReturn() ^ J 1204 

^ pop client registers 

save current mode info as old mode info 

save VESA BIOS MODE INFO as current mode info 
( includes mode dimension info ) 

inject original setmode call to original VESA BIOS INT 10 handler 

return to 
I wlntl OVesaEndReturn 
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J************************************************************^^ * 
* 

* FUNCTION NAME = wlntlOVesaEndReturn 

* DESCRIPTION 

* Does the post cleanup after the VESA BIOS mode set. 
* 

**************************************************************^^ 
wlntl OVesaEndReturn() 

^ if( AX( pcrf ) != VES/LFUNCTION.SUCCESS ) 
restore current mode info from old mode info 
else if( background ) 
freeze VDM 
j wlntlOContinue 

1*************************************************************^^ 

* FUNCTION NAME = wlntlOChain 

* DESCRIPTION 

* Continue with client INT 10 
* 

*************************************************************^^ 
wInt10Chain() 

* call original (VGA/VESA) BIOS INT 10 handler 
j return to wlntlOContinue 

/**************************************m 

* FUNCTION NAME = wlntlOContinue 

* DESCRIPTION 

* return to client program 
* 

************************************************************w^ 
wInt10Continue() 

return to client program 

i 
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I FUNCTION NAME = wDsvModeUpdate 

* DESCRIPTION 

* Determine current mode dimensions 

* These dimensions are used to determine: 

* A) How much VRAM to save and restore for emulation switching 

* B) How to draw current VRAM contents as a picture in a desktop window 
* 

wDsvModeUpdateQ 

* if ( VESA MODE ) 
/* New art: */ 

calculate mode dimensions from info returned by previous VESA calls 

(current mode info) 
else 

/* Prior art */ 
^ calculate mode dimensions from standard VGA registers 
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